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ABSTRACT 


This document describes the installation and use of 
CARDCHK, a program which tests and diagnoses Nestar 
network interface cards. Up to 7 cards may be tested at 
the same time in a single Apple. 
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CARDCHK Version 2.0 


Interface card test program 


The program CARDCHK allows up to seven Nestar Network Interface 
Cards to be tested in any of the Apple ][ Peripheral slots 1-7. 
The comprehensive testing program performs 14 tests on each card 
selected. Both hardware and software related devices in the card 
are tested, continuously if desired. By using CARDCHK the user can 
quickly test groups of seven cards, with information about which 
cards failed what tests being stored in memory. A simple user 
interface allows the user to quickly scan all the cards, to lock 
onto one particular card for inspection of failure data, or to halt 
the display before failure data is updated. 


CARDCHK is 5K in size and resides in memory between $1000 and $2400 
(4096-8216 in decimal). If CARDCHK is loaded from the network, the 
network cable should be disconnected from the network card to avoid 
interfering with users on the network. (CARDCHK can also be loaded 
from a local minifloppy disk.) Nothing other than the cards to be 
tested need be present in any other slot in order for CARDCHK to 
run. 


This document provides information needed to invoke CARDCHK, as 
well as a summary of CARDCHK commands, information on reentering 
CARDCHK from the Apple monitor or from BASIC, a summary of the 
screen display a summary of the failure analyis codes, and a list 
of suspect components for each test. 
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Installing CARDCHK 


CARDCHK is distributed on a 5 1/4" l6-sector minifloppy disk which 
has a bootable copy of Apple DOS 3.3.  CARDCHK can be run directly 
from this disk or it can be copied to a virtual DOS volume, or it 
can be copied to a virtual binary volume for quicker loading. 


The following instructions assume you have an operational file 
server connected to a user station which has a network interface 
card in slot 6 and a minifloppy disk controller in slot 4, set up 
for drive 1. The real disk containing the DOS file CARDCHK should 


be inserted in the drive. 
A) To copy CARDCHK from the floppy to a virtual DOS disk: 


Boot a virtual DOS 3.3 volume (e.g. /MAIN/DOS/3.3) Enter the 
following commands: (Note: the underlined portions are system 
responses.) 


]BLOAD CARDCHK,S4,Dl 


] PR#6 


]@MOUNT a DOS volume (e.g. /MAIN/USERS/JOE/DOS, D2, RW) 
0,0K 


]BSAVE CARDCHK, A$1000,L$1400,S6, D2 
B) To copy CARDCHK to a virtual binary volume for quicker loading: 


Boot a DOS 3.3 volume (e.g. /MAIN/DOS/3.3) Enter the following 
commands (noting that the underlined portions are system 


responses): 
]BLOAD CARDCHK,S4,Dl 
]PR£6 
]@CREATE /MAIN/SYSTEM/CARDCHK, T-B, SIZE=$14.S 


]@BSAVE /MAIN/SYSTEM/CARDCHK, FROM=$1000, SIZE=$1400.C 
0,0K 
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Invoking CARDCHK 
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(1) The card to be tested must have its address set according to 
the ROM type, e.g. 7F for Al.X ROMs, and FE for Bl.X ROMs. (See 
the Cluster/One, Model A System Manager's Manual, sections 2.1 
and 2.2.) 


(2) The card(s) must have a pullup resistor pack plugged into 
RN2. This pack must be removed from non-NFS cards prior to 


normal use. 


(3) The card(s) to be tested can be placed in any of the slots 
1-7. 


(4) To load and run CARDCHK: 


a) To load and run CARDCHK directly from the 5 1/4" floppy 
disk enter PR#4 followed by BRUN CARDCHK. 


b) To load and run CARDCHK from a network binary volume simply 
boot the pathname of the virtual binary volume. 


c) To load and run CARDCHK from a DOS virtual volume: 


Boot the DOS virtual volume containing the file CARDCHK 
then type BRUN CARDCHK. 


(5) Enter the number which corresponds to ROM type. (The ROM 
type is indicated on the chip with the Nestar Copyright message 
on it.) At this point you can instead press ESC and ; : will end 
up in the Apple monitor. 


(6) Type H if you would like CARDCHK to halt on the first error 
it finds, press RETURN otherwise. 


(7) Enter the numbers, in any order, of slots to be tested. (Any 
number between 1 and 7 is acceptable.) Its number will appear 
on the screen, somewhere to the right of the "SLOTS SELECTED:" 
message. To change your mind and not test a selected slot, 
while still in this input mode, reenter its number and it will 
disappear from the display. Entering the number one more time 
will select the slot again. In this way you may select any and 
all of the 7 slots to be tested. 
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CARDCHK Commands 
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(1) SCAN.....invoked by keying in 0 


causes CARDCHK to scan all of the cards that you have selected. 
CARDCHK will perform each of the 14 tests 16 times on whichever 
card is currently displayed as being tested, and will then move 
on to test the next card that you have selected. CARDCHK will 
loop back to test the first selected slot after it has tested 
the last selected slot. The errors recorded so far for each 
card are displayed when that card is being tested. Also, when a 
card fails a test its number on the "SLOTS SELECTED" line 
permanently turns to inverse video. In this way you may fill 
the Apple with seven interface cards, start CARDCHK, return in a 
few minutes, and at a glance you will be able to tell which 
cards have failed at least one test. 


(2) FREEZE...invoked by pressing ESC 


causes CARDCHK to freeze the display and halt execution until 
another command is entered. At this point you can press ESC 
again and the program will restart from the beginning. Then 
pressing ESC one more time will bring you to the Apple monitor. 
If you wish to resume the test that was suspended, press the 
slot number instead of ESC, or 0 to resume that test and then 
continue scanning. 


(3) LOCK.....invoked by keying in a selected slot number 


causes CARDCHK to lock onto the slot whose number you have 
entered. CARDCHK will perform all 14 tests 16 times on the card 
onto which you have locked. It will then proceed to test that 
slot again indefinitely. Keying in O will "unlock" CARDCHK and 
return it to scanning mode.  Keying in a number between l and 7 
will cause CARDCHK to immediately change the lock value to that 
of the new slot whose number was entered. 
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Reentering CARDCHK 


(1) If you see a * and then some numbers, and then a * on the 
next line, you are in the Apple Monitor. Type 1000G and then 
press RETURN and you should be back in CARDCHK. 


(2) If you see a ] or a > as a prompt then you are in BASIC. 
Type CALL 4096 followed by RETURN to reenter CARDCHK.  Hitting 
RESET (CTRL and RESET on some Apples,) at any time while running 
CARDCHK will cause the program to halt and BASIC to be entered. 
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Summary of Display 
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A typical CARDCHK display looks something like this: 


(Note: The numbers in triangular brackets do not appear on the 
screen. They appear in this example merely as line numbers to 
refer to in the explanation.) 


<l> TEST:01 0000 01D0. <===== 
«2»  TEST:02 01D0 0000 

<3> TEST:03 01D0 0000 

<4>  TEST:04 01D0 0000 

«5»  TEST:05 01D0 0000 

«6»  TEST:06 01D0 0000 

«7» TEST:07 O1DO 0000 

«8»  TEST:08 Ol1DO 0000 

«9»  TEST:09 01D0 0000 

<10> TEST:0A O1CO 0010 ===== 
<11> TEST:0B 01D0 0000 

<12> TEST:0C 01D0 0000 

<13> TEST:0D 01D0 0000 

<14> TEST:0E 01D0 0000 

<15> 

<16> TEST:0A FAILED. CODE:01 
<17> SYNDROME: FF 00 00 00 00 00 006 00 
<18> 

<19> 

<20> 

<21> 

<22> SLOTS SELECTED: 1 3[4] 6 [FAILED] 
<23> NOW TESTING SLOT: 03 

<24> == SCANNING <== 


(1) Lines 1-14 contain information about the 14 tests being 
performed. The first field indicates which test is being 
performed. The second and third fields show the number of times 
(in hex) the test was successful and unsuccessful, 
respectively. The arrows draw attention to any tests which have 
failed at least once. 


(2) Lines 16-17 contain more explanation about the last test 
that failed. See the Failure Code Analysis section for more 
details. 


(3) Line 22 tells you which slots you have selected. Numbers 
represented in inverse video refer to cards that have failed at 
least one test. 


(4) Line 23 tells you which slot you are currently testing. 
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(5) Line 24 tells you what mode you are in: LOCKED, FROZEN, or 
SCANNING. 


From this display we get the following information: 


--- The user has chosen to test slots 1,3,4 and 6. 
--- He is currently in the SCAN mode. 

--- Card 3 is now being tested. 

--- Tests 01 and OA have failed. 

--- The card in slot 4 has failed at least one test. 


(Its number on line 22 is in inverse video.) 


In this example, test OA failed, in subcase Ol. The test 
attempted to read in the address switch, and instead of getting 
the expected value, (7F for User station cards, FE for NFS 
cards,) it read in FF, the first byte shown in the Syndrome 


field. 


We can now look up a TEST 6, CODE 3 error in the Failure Code 
Analysis section. 


Note: In general, a failing test leaves the failure condition 
driven, and stops if HALT mode was chosen. If the failing card 
is on an extender, you can probe around and isolate the failing 
data path or IC with a meter or scope. 


Once a card has passed all tests, a final functional test is 
required. You should put the system on the bus, and boot up DOS 
or PASCAL. 
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CARDCHK V2.0 interface card test program error codes 


FAILURE CODE ANALYSIS 


Display on top part of screen: 


TEST:nn aaaa bbbb 
TEST:mm aaaa bbbb <==== 
etc. 


nn,mm are the test numbers 00 through OE. The next column (aaaa) 
indicates the number of times the test has run correctly since it 
has begun, and the last column (bbbb) indicates the number of 
failures. There will be an arrow (shown above) pointing to any test 
which has a non-zero number of failures. 


Failure display on bottom part of screen: 
TEST:nn FAILED. CODE:cc 
SYNDROME: [0] [1] [2] [3] [4] [5] [6] [7] 


Look up test nn below, and the code cc. A description of what is 
being tested for is shown. More detailed information on how the 
test failed is shown in up to 8 data bytes, labeled [0], [1], etc. 
as shown on the above layout. 


NOTE: Code FF is reported if during a test an unexpected interrupt 


occurs. It is likely this error is not associated with the 
particular test, but with a more general problem with the interface 
card. 


Code EE is reported if after completion of a test the card 
being tested has unexpectedly deselected. 
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TEST DESCRIPTION CODE SYNDROME 
nn cc 
01 Cn00 data stuck zeros Ol [0] data bits on are stuck zero 
02 Cn00 data stuck ones 01 [0] data bits on are stuck ones 
03 ROM address lines 01 [0] code for failing byte: 

or select problem 0-CnOO 1-CnOl1 2-Cn02 3-Cn04 


4-Cn08 5-CnlO 6-Cn20 7-Cn40 
8-Cn80 9-C900 A-CAOO B-CCOO 
[1] expected 
[2] found 


04 ROM checksum 01 [0] failing page: 
0-Cn00 1-C900 2-CA00 3-CBOO 


4-CCO0 5-CD00 6-CEOO 7-CFO00 
deselect ROM 02 deselect failed 
with CFFF reference 


ROM select speed test 03 [0] expected [1] found at Cn00 
ROM enabled on bus incorrectly 
04 (not significant) 
05 test RAM at C800 area failing address and data: 
check all data bits: 01 [0] high address 
store all values in C800 [1] low address 
read back [2] expected value 
[3] actual value 
check address lines: 02 
store values in C800..C8FF same as Ol 
check data bits: 03 
Stuck zeroes or ones same as 01 


06 PIA addressing and data 


U6 DDR A Ol [0] CF [1] FO [2] expected [3] actual 

U6 DDR B 02 [0] CF [1] F2 [2] expected [3] actual 

U7 DDR A 03 [0] CF [1] F4 [2] expected [3] actual 

U7 DDR B 04 [0] CF [1] F6 [2] expected [3] actual 

U6 PR B 05 [0] CF [1] F2 [2] expected [3] actual 

U7 PR B 06 [0] CF [1] F6 [2] expected [3] actua’ 
07 R/W network data bus 01 [0] data out 
, [1] data in 

(check resistor pack plugged in RN2) 

Data lines float on RESET 02 [0] ones indicate data lines which 


float low instead of high 
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08 Set HS1,HS2,HS3 drivers 01 [0] .....nnn HS3,HS2,HS1 levels expected 
[1] .....nnn HS3,HS2,HS1 levels actual 
Reset HS drivers 02 [0] .....nnn HS3,HS2,HS1 expected 0’s 
HS lines float on RESET 03 [0] .....nnn HS lines which 
float low instead of high 
09 reset HS1 in IRQ 01 can’t reset HS1 
set HS1 02 can’t set HS1 
reset HS2 03 can't. reset HS2 
set HS2 04 can't set HS2 
reset HS3 05 can't reset HS3 
set HS3 06 can’t set HS3 
0A Read in switch address 01 [0] incorrect address (not 7F or FE) 
(check address shunt) 
0B address comparator 01 IRQ set on adr<>7F/FE [0] address 
02 IRQ not set on adr=7F/FE [0] address 
03 level set on adr<>7F/FE [0] address 
04 level not set on adr=7F/FE [0] address 
oc RAM test 3 more pages 01 as in test 05 above 
(C900, CAOO, CBOO) 02 ue 
03 "t 
store 0..3 into 04 [0] expected [1] actual 
C800, C900, CA00,CBOO 
and read back 
OD Clock test Ol IRQA2 bit not set 
02 IRQA2 bit can’t reset 
force CPU interrupt 03 no interrupt was caused 
OE Clock speed test 
test for 0.1 sec speed 01 [0] speed (OK range is 1E to 25) 


(replace capacitor C2 if off) 
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Detailed Test Description and Failure Diagnosis 


This section describes each of the tests in detail, and lists the 
components of the Network Interface Card which are suspect if a 
particular test fails. 


In general, each test assumes that the previous tests have been 
successful, so subsequent errors may .actually be caused by a 
failure that corresponds to an earlier test. 


Testing multiple cards in a single Apple which are connected to the 
same network may result in a failure of one card inducing apparent 
failures in other cards. For this reason, it is best to keep the 
networks of all cards isolated and use separate pullup resistors in 
RN2. 


The suspect components listed below are not exhaustive, but rather 
list the most likely failed components in order of probablity. 
Also note that defects in the printed circuit board in the vicinity 
of the defective components is also to be investigated. 


What If CARDCHK Won’t Run, or If It Hangs the Apple 


If CARDCHK won’t run (or won’t boot) when a NIC is installed, then 
one of the signal lines connected to the Apple bus is defective. 
Most likely a signal is being held high or low, or the bus buffer 
(U16) is continually enabled. 


Suspect components: U16, U10, Ull, U17, Ul15, Ul4, U6, U7, U12, U13 


TEST 01 


The first 256 bytes of the ROM are read and ORed together. If the 
result is not FF, then one of the data lines from the ROM through 
the bus buffer is probably defective. Another possiblity is defect 
address logic for the ROM causing only certain locations to be 
read. 


Suspect components: U9, Ul6. 
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TEST 02 


The first 256 bytes of the ROM are read and ANDed together. If the 
result is not 00, then one of the the data lines from the ROM 
through the bus buffer is probably defective. Another possiblity 
is defect address logic for the PROM causing only certain locations 
to be read. 


Suspect components: U9, Ul6. 


TEST 03 


Bytes of the ROM are checked at locations 0, 1, 2, 4, 8, 16, 32, 
64, 128, 256, 512, and 1024 are compared against an internal table 
of correct values in order to verify that each of the address lines 
to the ROM are functioning. 


Suspect components: U9, Ul0. 


TEST 04, CODE 1 


A checksum of each of the 8 256-byte pages of the ROM is computed 
and compared against an internal table to check for incorrect 
locations. A failure probably indicates a bad or incorrectly 


programmed ROM. 


Suspect components: U9. 


TEST 04, CODE 2 


The card is deselected by referencing location CFFF, and then 
various locations in the ROM are checked to make sure that the ROM 
is no longer responding. A failure indicates that either the CFFF 
address decode is failing, or the card enable flipflop cannot be 


reset. 


Suspect components: U18, Ul4, U15, U17, Ull. 
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TEST 04, CODE 3 


With thc card disabled, the first byte of the ROM is accessed to 
cause the card to be selected and the ROM read in one operation. A 
failure at this point indicates a likely speed problem in selected 
the card or accessing the ROM. 


Suspect components: Ul4, U9, Ql. 


TEST 04, CODE 4 


This test for an obscure addressing failure which results in data 
appearing in the ló6-byte slot-depending address space. 


Suspect components: U10, Ull. 

TEST 05, CODE 1 

All values from 0 to 255 are stored and checked in the first byte 
of the RAM. 

Suspect components: U12 (bits 0-3), U13 (bits 4-7), Ul4, Ull. 

TEST 05, CODE 2 

Psuedo-random data is stored and checked in the first 256 bytes of 
the RAM. 

Suspect components: U12 (bits 0-2), Ul13 (bits 4-7). 

TEST 05, CODE 3 

Zeros and ones are stored and checked in each of the first 256 


bytes of the RAM. 


Suspect components: U12 (bits 0-2), U13 (bits 4-7). 
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TEST 06, SUBCODES 1-6 


Each pair of data direction registers (DDR) in each PIA, and each B 
data register (PR B) are tested by storing and checking all values 
from 0 to 255. Failures in subcodes 1 to 6 represent failures in 
U6 DDR A, U6 DDR B, U7 DDR A, U7 DDR B, U6 PR B, and U7 PR B, 
respectively. 


Suspect components: U6, U7. 


TEST 07, CODE 1 


All possible data values are written by PIA U6 throught the 
transceivers and back into U6. For this test to succeed, the 
network bus must have pullups either in RN2 or some other location 
attached via a network cable. In addition, PIA U6 data ports, the 
data transcievers U2 and U5, as well as output PB4 from PIA U7 must 


be functioning. 


Suspect components: RN2, U2 (bits 0-3), U5 (bits 4-7), U6, U7. 


TEST 07, CODE 2 


The value 0 is put on the network bus, and then the PIAs are put 
back into the reset state so that they are not driving the network 
transceivers. This simulates the case of a hardware reset and 
checks that the network bus will not be driven under those 
circumstances. 


Cards prior to Revision F do not have a positive mechanism for 
insuring that the bus will not be driven under these 
circumstances. A failure of this test for those early cards does 
not necessarily indicate that the card will fail in normal use. 


Suspect components: U2 (bits 0-3), U5 (bits 4-7), U7. 
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TEST 08, CODE 1 


The handshake lines HS1, HS2, and HS3 are checked to see that all 8 
possitle combinations can be set and read. : 


Suspect components: U4, RN2, U6, U7. 


TEST 08, CODE 2 


The handshake line transciever (U4) is tested to make sure that it 
can be disabled and will return 0 for all handshakes even though 
they are being driven to l. 


Suspect components: U4. 


TEST 08, CODE 3 


This checks that the handshake line transciever (U4) will be 
disabled when the enable line PB4 is not driven. 


Suspect components: U4. 


TEST 09, CODES 1-6 


This test forces transitions on the handshakes signals, and tests 
that the PIAs report the interrupt and can be reset from software. 


Suspect components: U6 (CODE 1-4), U7 (CODE 5-6) 


TEST 0A 


The station address switch is read and checked against the 
factory-set values of 7F or FE for A or B series ROMs, 
respectively. 


Suspect components: Sl, RN1, U3, U7, Ul. 
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TEST OB, CODES 1-4 


All values from 0 to 255 are sent on the data bus, and the switch 
address comparitor is checked to make sure that it responds only to 
the address set in the switch. 


Suspect components: Ul, Ul18, U7. 


TEST OC, CODE 1-3 


This is identical to TEST 5, except that the 2nd, 3rd, and 4th 
256-byte pages are RAM are tested in CODES 1, 2, and 3, 
respectively. 


Suspect components: U12 (bits 0-3), U13 (bits 4-7), U7 (pin 13), 
Ul4. 


TEST OC, CODE 4 


Problems with the high-order address lines are checked by storing 
different values in the same location in four different pages in 
RAM and checking that they are correct. 


Suspect components: Ul2, U13 (pins 7 and 15). 

TEST OD, CODE 1 

The 10 Hz interrupt timer is checked to see that it generates PIA 
interrupt input. 

Suspect components: U8, Rl, R2, C2, U7. 


TEST OD, CODE 2 


This checks that the timer interrupt can be reset. 


Suspect components: U7 
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TEST OD, CODE 3 
This verifies that a timer interrupt from PIA U7 can cause a true 


Apple 6502 interrupt. 


Suspect components: U7, or the Apple interrupt logic. 

TEST OE 

The timer accuracy is checked. 

Suspect components: C2, Rl, R2, U8. 

ANY TEST, CODE FF 

If an unexpected interrupt occurs during any test, an error code FF 
is reported. 

Suspect components: Uo, U7. 

ANY TEST, CODE EE 

If an unexpected deselection of the network card occurs during any 


test, error code EE is reported. 


Suspect components: U18, Ull, Ul4, U17. 
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